Doublespinner
Doublespinner
- Demonstration: Spinner
- Java API: Doublespinner
- JavaScript API: Doublespinner
- Style Guide: Doublespinner
Employment/Purpose
An edit box for holding a constrained double.
Example
<doublespinner step="0.5" />
In-place Editing
Fixed Width
<doublespinner width="100px" inplace="true" value="30" />
Dynamic Width
Because inplace editing function in ZK is pure client side action, so we can use client api to modify the width (server side do not need to know)
<zk xmlns:c="client">
<doublespinner inplace="true" value="240" width="30px" c:onFocus='this.setWidth("60px")' c:onBlur='this.setWidth("30px")' />
</zk>
Properties
Format
You are able to format the field by providing specifying the attribute with a formatting string. The default value is null
.
<doublespinner format="#,##0.##"/>
Since 8.5.2
You can provide a locale to format the number by specify the String starts with "locale:"
<doublespinner format="locale:zh-TW"/>
Constraint
You could specify what value to accept for input controls by use of the constraint
property.
It could be a combination of no empty
and the minimum and maximum to doublespinner.
To specify two or more constraints, use comma to separate them as follows.
<doublespinner step="0.5" constraint="no empty,min -2.5 max 6.5"/>
If you prefer to display different message to the default one, you can append the error message to the constraint with a colon.
<doublespinner step="0.5" constraint="no empty,min -2.5 max 6.5: between -2.5 to 6.5"/>
Notes:
- The error message, if specified, must be the last element and start with colon.
- To support multiple languages, you could use the 「l」 function as depicted in the Internationalization chapter.
<doublespinner step="0.5" constraint="no empty,min -2.5 max 6.5: ${c:l('err.msg.doublespinner')}"/>
Inherited Functions
Please refer to NumberInputElement for inherited functions.
Supported Events
None | None |
- Inherited Supported Events: NumberInputElement
Supported Molds
Available molds of a component are defined in lang.xml embedded in zul.jar.
Supported Children
*None
Use Cases
Version | Description | Example Location |
---|---|---|
Version History
Version | Date | Content |
---|---|---|
5.0.6 | Dec. 2010 | add new component |